home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Util / conv / Acvt.lha / Acvt 1.07 / docs / readme.txt < prev    next >
Text File  |  2001-03-08  |  4KB  |  153 lines
  1. Acvt v1.07 (c) 2000-2001 Jindrich Kubec <kubecj@asw.cz>
  2. Latest version can be found at http://www.asw.cz/~kubecj
  3.  
  4. This program is provided 'as is', no warranty will be taken
  5. for any damage caused by it or by any use of it.
  6.  
  7. The whole package is placed under the GNU Public License, for further
  8. information on redistribution see the included file "GPL.TXT".
  9.  
  10.  
  11. Description:
  12. ------------
  13. Converts between XFD-SCP-ATR-DCM-DI formats.
  14. ATR - SIO2PC images
  15. XFD - XFormer images
  16. DCM - DiskCommunicator images
  17. SCP - SpartaDos SCOPY images
  18. DI  - XL/ST link / XLDJ disk images
  19.  
  20. It's replacement for DOS version of Steven Tucker's Imagic.
  21. It's in fact better because:
  22. 1) It's free.
  23. 2) It comes with source.
  24. 3) Therefore it could be ported to another architectures.
  25. 4) Contains less bugs. (Hope so.)
  26. 5) Can repair some invalid images.
  27. 6) Now also supports DI file format.
  28.  
  29. Thanks go to:
  30. Ernest Schreurs for his DiskCommunicator dissection and paper about DCM format.
  31. Chad Wagner for DCMtoATR utility (DCM driver is still loosely based on his
  32.     code).
  33. Burian brothers for lots of DI files.
  34.  
  35.  
  36. Usage:
  37. ------
  38. Acvt [options] sourcefile [destfile]
  39.  
  40. sourcefile is Atari disk image (ATR,XFD,SCP,DCM,DI).
  41.  
  42. destfile is output disk image. If omitted, output filename is created
  43.  automatically.
  44.  
  45. -xfd -atr -scp -dcm -di options are output type modes. Default is -atr.
  46.  
  47. -batchmode: turns on multi file processing mode. Only input files are specified
  48.  on command-line (Unix-like compatible regexp expressions are allowed when
  49.  compiled under DJGPP). Output filenames are created automatically.
  50.  
  51. -autorepair: automatically determines the best repair method.
  52.  
  53. -norepair: doesn't ask for repair options and considers input file invalid.
  54.  
  55. -errstop: in batch mode ends on first error encountered.
  56.  
  57. -over: overwrites existing files. Otherwise returns an error.
  58.  
  59. -test: only loads input images and displays their state.
  60.  
  61. -classic: forces to create 'classic' Atari disk sizes.
  62.  
  63.  
  64. History:
  65. --------
  66. Date, Author, Version
  67. 5/22/1999, kubecj, 0.10
  68. First version
  69.  
  70. 5/25/1999, kubecj, 0.15
  71. SCP save added
  72.  
  73. 5/29/1999, kubecj, 0.20
  74. DCM save added, decompression corrected
  75.  
  76. 5/30/1999, kubecj, 0.30
  77. Code cleanup
  78.  
  79. 6/1/1999, kubecj, 0.35
  80. Invalid DD ATR repair added
  81.  
  82. 6/2/1999, kubecj, 0.40
  83. Invalid DD XFD repair added
  84. Invalid ATR length repair added
  85. Added cached read for DCM decompression
  86.  
  87. 6/3/1999, kubecj, 0.42
  88. Code cleanup
  89.  
  90. 6/4/1999, kubecj, 0.43
  91. Added checks for DCM decompression
  92. Check for multi-arc
  93.  
  94. 6/5/1999, kubecj, 1.00
  95. First public version
  96.  
  97. 6/10/1999, kubecj, 1.01
  98. Compatibility macros & valid archive :)
  99.  
  100. 6/11/1999, kubecj, 1.02
  101. Repaired repairing ;)
  102.  
  103. 6/13/1999, kubecj, 1.03
  104. Changed switches processing
  105.  
  106. 10/10/1999, kubecj, 1.04
  107. Only changed generation of archive, new version to avoid version checking
  108. problems.
  109.  
  110. 6/6/2000, kubecj, 1.05
  111. Minor bugfix concerning repairing.
  112. Added -classic commandline switch to force to create 'classic' disk sizes.
  113.  
  114. 2/26/2001, kubecj, 1.06
  115. Added DI file format. Its support is just a beta!
  116.  
  117. 3/8/2001, kubecj, 1.07
  118. Handling of double sided diskettes in DI format.
  119.  
  120.  
  121. To Do:
  122. ------
  123. Maybe check pass count in DCM images?
  124. Better handling of DI files.
  125.  
  126.  
  127. Known Bugs:
  128. -----------
  129. DCM record 0x42 is not decompressed, code is present, but commented out and 
  130.  untested. I need some sample first.
  131.  
  132. DI files are really an educated guess. There are many 'white places' for me.
  133. I need the description of the disk format.
  134.  
  135. Function for actual conversion is stupid. In fact in order to convert ATR to
  136.  XFD there is created Atr object, loaded in, and same Xfd object is created and 
  137.  all the data are duplicated. With 16MB SpartaDOS Atr images it's simply too 
  138.  much.
  139.  
  140.  
  141. Compiling Tools:
  142. ----------------
  143. For scripts: Perl.
  144. URL: http://www.perl.com
  145.  
  146. For PC executables: DJGPP.
  147. Sources were written/tested on GCC/Intel only. There should be only
  148. minor problems to port it to different architectures/environments.
  149. Makefile should need only minor changes.
  150. URL: http://www.delorie.com
  151.  
  152.  
  153.